home *** CD-ROM | disk | FTP | other *** search
/ The Epic Collection 3 / Epic Collection 3, The (1997)(Epic Marketing)[!].iso / 3dobjectz / readme.txt < prev    next >
Text File  |  1978-03-24  |  7KB  |  203 lines
  1. To view our range of lightwave and imagine objects on our cd, you need to
  2. double-click on the showobj icon, click OK, and then using the file
  3. requester click volumes, epiccollection3, 3dobjects, and your away!
  4.  
  5.  
  6. ---------------------------------------------------------------------------
  7.                                  Showobj V2.1
  8.            An Imagine TDDD-object and LightWave LWOB-object displayer.
  9.                        Copyright 1994,95 by Andreas Heumann.
  10.                               All Rights reserverd.
  11. ---------------------------------------------------------------------------
  12.  
  13. Requirements
  14. ============
  15.  
  16. Showobj requires at least OS 2.0, nevertheless it should run on any machine
  17. with any processor.
  18. Tested with:
  19. A2000 4Mb 68030/882 ECS
  20. A2000 9Mb 60040, Merlin Gfx Board
  21.  
  22. Introduction
  23. ============
  24.  
  25. Showobj takes a file in Imagine's TDDD (3D data description) or in
  26. LightWave's LWOB format and displays it's contents in a window on a public
  27. screen, or if no is given on Workbench. If no filename is given, the
  28. program will ask for it with a filerequester.
  29.  
  30. Showobj can display the objects in three different modes:
  31. - boundingbox mode
  32. - wireframe mode
  33. - solid mode
  34.  
  35. Four views can be selected:
  36. - front view
  37. - right view
  38. - top view
  39. - perspective view
  40.  
  41. In perspective view the object can be rotated with the mouse while
  42. pressing the left mouse button, and zoomed while pressing the right
  43. button
  44. In front, right and top view it can be moved with mouse while pressing
  45. the left button.
  46. With the cursor keys in object is moved in front, right and top view,
  47. and rotated in perspective view.
  48.  
  49. It`s possible to track the Camera in perspective mode to the objects,
  50. and get information about them. Objects tracking to are drawed in a
  51. different color.
  52.  
  53. Solid mode is realized with a Z-Buffer algorithm which will take a large
  54. amount of memory in high resolution modes (655kByte with 640x256,
  55. 1,8Mb with 800x600 and 3Mb with 1024x768).
  56. If there's not enough memory available the window is divided into stripes.
  57.  
  58. Inputs
  59. ======
  60.  
  61. TDDD: Can read and display:
  62.       - normal Objects saved in detail editor
  63.       - perfect spheres
  64.       - grounds
  65.       Can't read and display:
  66.       - Lamps
  67.       - Others than the first state of a state-object
  68.       - Others than the first state of a cycle-object
  69.       - Paths
  70.       - Objects saved in forms or spline editor
  71. LWOB: Can't diplay polygons with more than four points (rectangles)
  72.       in shaded mode.
  73.  
  74. Usage
  75. =====
  76.  
  77. showobj [verbose] [pubscreen <name>] filename
  78.  
  79. With:
  80.  
  81. verbose verbose mode, displays information about file
  82.         TDDD: names of Objects; amount of objects, faces, edges and points
  83.         LWOB: names of Surfaces; amount of surfaces, faces, edges and points
  84.  
  85. pubscreen opens showobj window on given pubscreen
  86.  
  87. filename  name of the TDDD-file which is displayed, if no name is given
  88.           a filerequester appears.
  89.  
  90. This keys can be used while displaying the object:
  91.  
  92. ESC  -  Quit
  93. HELP -  Showes keys used by showobj
  94. a    -  Showes informations about object
  95. w    -  Switches wireframe mode on
  96. b    -  Switches bounding box on
  97. s    -  Switches solid mode on
  98. f    -  Switches to front view
  99. r    -  Switches to right view
  100. t    -  Switches to top view
  101. p    -  Switches to perspective view
  102. i    -  Zoomes in
  103. o    -  Zoomes out
  104. n    -  Track to next object
  105. Cursorkeys to move in front, right and top view and to rotate in
  106. perspective view
  107.  
  108. Disclaimer
  109. ==========
  110.  
  111. Standard disclaimer:
  112.  
  113. THERE IS NO WARRANTY FOR THIS PROGRAM TO THE EXTENT PERMITTED BY APPLICABLE
  114. LAW.  EXCEPT WHERE OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR
  115. OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND,
  116. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  117. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE
  118. ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
  119. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  120. SERVICING, REPAIR OR CORRECTION.
  121.  
  122. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
  123. ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM
  124. AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
  125. SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  126. INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
  127. DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
  128. OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF
  129. SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  130. DAMAGES.
  131.  
  132. Copyright
  133. =========
  134.  
  135. Showobj 2.0 is Copyright 1994 by Andreas Heumann. All Rights Reserved. It is
  136. released under the concept of `Cardware'. So if you like it please send me
  137. a postcard of your city. It has never been, nor will it ever be in the
  138. `Public Domain'.
  139.  
  140. The archive may only be distributed in unmodified form.  No files may be
  141. added, changed or removed. You may not charge for this archive, other than
  142. the cost of the media and duplication fees. Distribution is allowed in all
  143. forms, such as BB systems, floppy or compact disks, and ftp sites.
  144.  
  145. Any inclusion in a commercial, semi-commercial or Shareware distribution
  146. requires the written permission of the author.
  147.  
  148. History
  149. =======
  150.  
  151. 07.06.1994  first public release (1.0)
  152. 12.09.1994  added asl filerequester (1.01)
  153. 03.10.1994  added solid mode (1.02)
  154. 09.11.1994  added perspective mode (1.03)
  155. 02.12.1994  added z-buffer (YEAH!!) (1.1)
  156. 15.12.1994  z-buffer now works with stripes (1.11)
  157. 16.12.1994  added perfect sphere and ground (with SHP2- and SHAP-Chunk)
  158. 18.12.1994  some minor changes, cleanup (2.0)
  159. 26.12.1994  fixed bug in perpective mode (problems with large objects)
  160.             moving objects with mouse in FRONT-,RIGHT- and TOP-view is now
  161.             possible
  162. 31.12.1994  added LightWave support (2.1)
  163. 02.01.1995  solid mode is now more than twice as fast
  164.             little speedup in perspective wireframe and boundingbox mode (10%)
  165. 02.01.1995  object is now automatically placed in the middle of the screen
  166. 05.01.1995  little bugfix; test if object outside was wrong
  167. 11.01.1995  added rectangles for ligtwave objects
  168.             object is now automatically zommed to fit best on screen
  169.  
  170. Author
  171. ======
  172.  
  173. For bug reports, comments, suggestions ... you can contact me at the
  174. following address.
  175.  
  176.   Andreas Heumann
  177.   Heilmeyersteige 105
  178.   89075 Ulm
  179.   Germany
  180.  
  181.   E-Mail: heumann@hugo.rz.fh-ulm.de
  182.  
  183. Thanks
  184. ======
  185.  
  186. Special thanks goes to:
  187.   Massimo Tofani
  188.   Alessio Cappelli
  189. for their postcards and suggestions,
  190.   Christian Geisert
  191. for writing through E-Mail, and
  192.   Nigel Critten
  193. for the description of the LightWave format.
  194.  
  195. Also thanks to Mike Hesser for help and motivation and to Stephan Dorenkamp
  196. for testing.
  197.  
  198. Planed for the future
  199. =====================
  200.  
  201.  - 16 color grayscale solid
  202.  - speed up (hope to get new compiler soon)
  203.